home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / filed39a.zip / readme.txt < prev   
Text File  |  1993-08-07  |  3KB  |  84 lines
  1. This is the readme file for the port to OS/2 1.x--2.x and DOS of 
  2. Ian Darwin's file(1) command.  The UNIX program attempts to determine 
  3. the type of file based on the contents. A database of signatures 
  4. (the magic(4) file) is used.
  5.  
  6. Excerpted from the man-page:
  7.  
  8.   File tests each argument in an  attempt  to  classify  it.
  9.   There  are  three  sets of tests, performed in this order:
  10.   filesystem tests, magic number tests, and language  tests.
  11.   The  first  test  that succeeds causes the file type to be
  12.   printed.
  13.  
  14.  
  15. Example:
  16.  
  17.  [c:\tmp]file *
  18.  bin:         directory
  19.  file.1:      troff or preprocessor input text
  20.  file39a.zip: Zip archive (at least v2.0 to extract)
  21.  textfile:    English text
  22.  pencils.gif: GIF picture version 87a 800 x 800, interlaced, 256 colors
  23.  tarfile:     tar archive
  24.  tarfile.Z:   block compressed data - 16 bits
  25.  
  26.  
  27. Darwin's version has several enhancements over the usual UNIX versions,
  28. including:
  29.  1. More flexible magicfile entries.
  30.  
  31.  2. An "ascii magic" routine for keywords which can appear anywhere in 
  32.     the file.
  33.  
  34.  3. "-z" option will recursively unwind compress'd files to determine
  35.     the types.
  36.  
  37. This OS/2 port has an additional enhancement:
  38.  4. DosQ[uery]AppType is used to determine the type (DOS, OS/2, 32-bit,
  39.     etc.) of an executable or DLL.
  40.  
  41. QUICK START: This archive contains only the DOS executable; see
  42. src/Where to find locations for OS/2 executables and sources.
  43. Copy the file "magic" to one of the following locations:
  44.  * /etc/
  45.  * directory of the exectable
  46.  * a directory in PATH or DPATH
  47. or use the command-line option "-m" to specify the magicfile location.
  48.  
  49. Now try:
  50.  file *      or      file *.*
  51.  
  52.  
  53. Notes:
  54. 1. file v3 patchlevel9 is by Ian Darwin (darwin@cs.toronto.edu); see
  55. the README file. This is the second release of the OS/2 version. Many
  56. thanks to Greg Roelofs (newt@uchicago.edu) for the help.
  57.  
  58. 2. The magicfile needs more work. There are some other suggestions in
  59. notes*.os2. Thanks to Jouni Miettunen (jon@stekt.oulu.fi) for the
  60. contributions. Darwin collects magicfile entries.
  61.  
  62. 3. See the files notes*.os2 for additional information on the OS/2 and
  63. DOS ports. This is the first port to OS/2 and DOS; feedback and
  64. magic-file entries are welcomed.
  65.  
  66. 4. The *.man files are formatted by "groff -man"; as such, they are
  67. intended to be read with the "less" pager. This pager is available at
  68.   oak.oakland.edu:/pub/msdos/txtutl/less177e.zip
  69.  
  70. --
  71. Darrel Hankerson  hankedr@mail.auburn.edu  or  hank@ducvax.auburn.edu
  72. 11-Apr-93, updated 30-Jul-93
  73.  
  74. OS/2 version 3.9 to 3.9a updates:
  75.  
  76. Fixes: correct display of date info (e.g., on gzip'd files); fix
  77. message on OS/2 exe's with no application type; correct code
  78. which could cause trouble with the "-c" option on bad input. 
  79. Additions and corrections to the magic-file.
  80.  
  81. Changes: In OS/2 versions, continue on to the magic-file checks
  82. in the case that DosQueryApptype indicates a DOS executable. This 
  83. permits use of the checks for special (e.g., compressed) executables.
  84.